Lave Academy OXP by Thargoid
----------------------------

With the rise of interest in becoming a space pilot following the recent galactic financial troubles, Lave Academy has never been busier. To help in both the training of new recruits, plus the skills maintenance and re-certification of more experienced commanders, they have invested in a new orbital station equipped to offer training in three key areas - piloting, gunnery and docking.

It is designed for both new commanders who need a bit of practice before venturing out into the wild black galaxy. The courses are however also open to more seasoned veterans who would like to return to their alma mata and show off their skills to the student populus.

As the popularity has grown further, new stations have been planned for other locations, both in Galaxy 1 and beyond.

This updated version is for Oolite 1.77 and higher. It will not work with older versions of the game.

------------------------------------------------------------------------------------------------------------------------------------------------------------
Brief Instructions
------------------

* Station located at the edge of the security zone of Lave station (G1). A new buoy is also spawned part-way between the main station Nav-buoy and the Academy. Simply fly to the Nav-buoy and face towards the new buoy on your scanner to line up with the Academy (it should be visible anyway). Alternatively you can follow "A" on your ASC where fitted.
* Dock with station by flying into the blue glow in the centre.
* Three training missions available, via special screen accessible by F8 when docked at the station.
* Instructions given in-game, plus detailed instructions below.
* Once test is selected, launch and the fly to the relevant course buoy. It will communicate to your ship to indicate which one to approach.
* For the docking and gunnery tests, keep the main course buoy on-screen at all times during the test.
* All tests are against the clock, with the best time for each recorded.

------------------------------------------------------------------------------------------------------------------------------------------------------------
Known Issues and Incompatibilities
----------------------------------

* Take care with the docking test, as the drones are very solid and can make just as much a mess of your ship as a real station can.

* To prevent distracting information appearing from the course buoys, the OXP disables the Planetary Information System (Welcome Mat) at the beginning of the tests. It is re-enabled once they are completed or aborted.

------------------------------------------------------------------------------------------------------------------------------------------------------------
OXPConfig settings
------------------

This OXP is designed to work with OXPconfig, to allow tweaks to the number of academies that appear:

ExtraA = false, (ExtraB ignored) - only the academy at Lave will appear.
ExtraA = true, ExtraB = false - One academy will appear per galaxy.
ExtraA = true, ExtraB = true - Five academies will appear per galaxy.

The locations are as follows:

Galaxy 1 - Lave, Esteonbi, Enonla, Esanbe, Xequerin.
Galaxy 2 - Maesaron, Erenanri, Reveabe, Legeara, Tigebere.
Galaxy 3 - Radiqu, Edxeri, Ceedleon, Atius,Rerebi.
Galaxy 4 - Mavelege, Bemate, Cebitiza,  Mausra, Ensoor.
Galaxy 5 - Zaaner, Vebi, Inenares, Azaenbi, Dioris.
Galaxy 6 - Teesso, Oresmaa, Celaan, Ariqu, Inesbe.
Galaxy 7 - Isdilaon, Aenbi, Ataer, Orreedon, Qutegequ.
Galaxy 8 - Ceenza, Aarzari, Biatzate, Inbein, Oredrier.

For one academy per galaxy, the first planet in each list will be its host.

------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Details and Instructions
-----------------------------

Lave Academy Orbital Station
----------------------------

This large structure can be found in orbit around the planet Lave in Galaxy 1, just at the edge of the security zone of the main planetary station. It can easily be found by launching from there and locating the way marker buoy on your scanner. This is roughly half way between the station and the Academy, which should be easily visible behind it. Alternatively for ships equipped with such equipment, it can be found by selecting "A" on your advanced space compass. 

As this is an official Galcop location, trading of any commodity is banned, and due to its academic nature the only general equipment available is the witchspace fuel that may be needed for or consumed in undertaking the training tests. Therefore the normal marketplace information screen (F8) is now replaced by an access screen where you can review and sign up for the three offered training courses.

The station itself has been especially designed for its purpose, with thought towards its users and their general lack of experience in maneuvering and docking. At great expense a special system has been employed of tractor-beam assisted docking. To engage this, all the commander needs to do is to fly into the blue glowing area in the stations centre and the system will automatically take over and bring the ship into the station. For commanders whose ships are equipped with docking computers, these may also be used. It should also be noted that after some recent unfortunate incidents with ships equipped with semi-AI defense turrets, such ships are presently banned from docking at the Lave Academy orbital station.

Once docking is completed, one of the three available tests can be selected from the F8 screen. Each of these has built-in instructions, but more details are given below. All three are based around specially equipped course buoys which can be found in the vicinity of the station (all are within standard scanner range at launch). When a course is accepted and the commander launches from the station, the relevant buoy will automatically detect the ship and initiate communications with it to guide it to the correct place. Each course will begin within a few seconds of the ship approaching the buoy.

One final note, for those wishing to cause trouble, the academy is defended by a small squadron of very well equipped Vipers and Viper Interceptors who are experienced at dealing with unruly students.


Piloting Course
---------------

This course is offered to improve and test the commanders skills in astro-navigation and in ship handling. Once the test has begun, the commander needs to fly in sequence to a number of buoys which make up the course. Each buoy will identify itself by communicating with the ship, and must be approached to proceed to the next one. To make things more interesting a number of asteroids also populate the course area, which must be avoided. They can also be destroyed, but this is considered minor cheating and incurs a small time penalty. The course is run against the clock, with the best time being noted.

Also randomly placed within the course are a number of standard-issue ring drones. When flown through, these give a bonus time reduction to the commanders overall score. It is up to their skill and judgement to decide whether the time taken to detour through them is worth the bonus that they give (flying through them is optional, the course can be successfully completed without utilising them).


Gunnery Course
--------------

This is the most popular course in the academy, colloquially known as the "Shooting Gallery". When the buoy is approached and the test begun, it generates in sequence three sets of 5 target drones, each of which must be destroyed. These drones have a maximum lifetime of 30 to 60 seconds (depending on the commanders rank and ships equipment), after which they automatically self-destruct. The drone lifetime is announced at the beginning of the test by the buoy. The drones at level one are static, whilst those of the other two levels move faster and are increasingly more agile and a challenge to hit.

The test ends once all fifteen drones have been destroyed or have self-destructed, and the best time achieved is recorded. One other key consideration is that throughout the test the commander must keep the main buoy within scanner range, or else the test will be aborted. 


Docking Course
--------------

The last of the three tests, and arguably the most challenging, is the docking practice course. This simulates the requirements to dock with a standard station "letterbox" docking bay, one of the most difficult routine tasks a commander faces (and no, in this one you can't use a docking computer!). Once buoy approach is completed and the test begun, three sets of three drones will appear in sequence. The first set is simply for familiarisation, and has a large ring which must be flown through. The second set is similar, but an insert appears within the ring, gradually restricting its size down to that of a standard docking bay. The third set are the same as the second, except this time both the ring and insert begin to rotate, to fully simulate the conditions when docking with a real station for the final buoy.

It should be noted that approaches to the drones should be made slowly, as there have been cases of students who got over-confident with the accelerator smashing their ships against the drones with fatal consequences. To aid in successful traversal a line of glowing mini-buoys (nicknamed the "trail of breadcrumbs" by students) indicate the ideal path to take through the drone. The drones are also programmed to orient themselves perpendicularly to the main course buoy, so this can also be used to orientate the ship in lieu of the normal station nav-buoy.

Finally each drone must be successfully traversed within a three minute window of its appearance, or else it will self-destruct. And at all times the commander must keep the main buoy on his scanner, or else the test will automatically be aborted. 

------------------------------------------------------------------------------------------------------------------------------------------------------------

License:

This OXP is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license with the following clauses:

* Whilst you are free (and encouraged) to re-use any of the scripting, models or texturing in this OXP, the usage must be distinct from that within this OXP. Unique identifiers such as (but not limited to) unique shipdata.plist entity keys, mission variables, script names (this.name), equipment identity strings (EQ_), description list arrays and entity roles must not be re-used without prior agreement. Basically if it's unique or would identify or overwrite anything in the original OXP, then you may not re-use it (for obvious compatibility reasons).
* rebundling of this OXP within another distribution is permitted as long as it is unchanged. The following derivates however are permitted and except from the above:
	* the conversion of files between XML and openStep.
	* the merging of files with other files of the same type from other OXPs.
* The license information (either as this file or merged into a larger one) must be included in the OXP.
* Even though it is not compulsory, if you are re-using any sizable or recognisable piece of this OXP, please let me know :)


------------------------------------------------------------------------------------------------------------------------------------------------------------
Instructions
------------

Unzip the file, and then move the folder "Lave Academy 1.33.oxp" to the AddOns directory of your Oolite installation. Then start the game up and the ships should be added. 

------------------------------------------------------------------------------------------------------------------------------------------------------------
Version History
---------------
29/06/2025 - Version 2.2, moved all text to descriptions.plist and missiontext.plist for easier localisation.
		Changed calculation for spawning location to prevent buoys crashing into the planet.
23/02/2024 - Version 2.1, added missing ";" to various entries in the shipdata.plist file.
13/02/2024 - Version 2.0, Updated Academy textures, added normal map and specular map, switched to using default Oolite shaders.
		Turned off "smooth" on the Academy definition.
		Made it possible to save your game at the Academy.
		Switched Academy Waymarker Buoy to use default Oolite buoy.
		Tweaked text of F4 interface entry.
		Added interface to Library Config for controlling when to spawn Academies.
		Spawning settings now saved with the save game.
		Changed course progression messages to always come from the associated marker buoy.
		Added a docking texture for BGS.
		Code refactoring.
07/10/2014 - Version 1.34, tweak to shipdata.plist for iMac compatibility.
05/02/2013 - Version 1.33, update to restore compatibility with OXPConfig.
08/01/2013 - Version 1.32, update for v1.77 (now minimum version) with new logs and interface access.
31/12/2011 - Version 1.31, small script update to stop log errors in 1.76.
20/02/2011 - Version 1.30, update to try and make docking rings less deadly.
13/02/2011 - Version 1.21, removal of upper limit, to allow running with 1.75
17/04/2010 - Version 1.20, scripting for v1.74 - now no longer compatible with older versions of the game.
15/09/2009 - Version 1.11, minor change to shipdata.plist to remove a potential issue.
25/08/2009 - Version 1.1, script update for v1.73 compatibility (setPosition and setOrientation depreciation), plus optional addition of extra academies.
10/03/2009 - Version 1.02, scripting adjustment to spawn the Academy and buoys (and the pilot course) relative to the main station, rather than absolute.
09/03/2009 - Version 1.01, modifications based on feedback:
		Added a buoy part-way between the main station Nav-buoy and the academy, to point people in the right direction.
		Modified the target drones lifetime to 30s + 10s each for commanders with <16 kills, without fuel injectors and with only pulse lasers.
		Tweaked the script a bit to prevent incorrect messages for new Jamesons, due to lack of save game & use of mission variables.
		Reworked the pilot buoy/drone scripts to prevent the crash to desktop if the 15 minute timer elapses.
04/03/2009 - Version 1.00, Initial release.

------------------------------------------------------------------------------------------------------------------------------------------------------------
Acknowledgements
----------------

With thanks to:
* Griff for the superb shaders and overall appearance of the station.
* Lestradae and PAGroove for the discussions and beta-testing.
* Eric Walch and Kaks for deep playtesting and bug reporting on the positioning issue (which was a bug in the 1.72.2 trunk).
* _ds_ for the core patch to enable icons in the ASC, and for the fuel pump icon in this OXP.
* Dr Beeb for the idea of multiple galaxies.
* Wildeblood for the heads-up on the 1.76 log errors.
* Captain Beatnik for the iMac heads-up for v1.34.